======================================================================
                 PANDUAN PENGGUNAAN ASIATRADECT V2
                    MT4 - MT5 COPY TRADING EA
                         asiatradevps.com
======================================================================

Versi panduan : 2.00
Produk         : AsiaTradeCT V2
Platform       : MetaTrader 4 dan MetaTrader 5


DAFTAR ISI
----------------------------------------------------------------------
1. Fungsi dan kemampuan EA
2. Persyaratan penggunaan
3. File yang digunakan
4. Instalasi pada MetaTrader 4
5. Instalasi pada MetaTrader 5
6. Mengaktifkan WebRequest
7. Memasukkan LicenseKey
8. Menautkan Master dan Copier
9. Contoh MT5 Master ke MT4 Copier
10. Penjelasan parameter input EA
11. Penjelasan dashboard
12. Cara menggunakan market dan pending order
13. Perbedaan digit dan nama simbol broker
14. Akun Hedging dan Netting
15. Penggunaan beberapa pair
16. Status dan troubleshooting
17. Checklist pengujian
18. Catatan keamanan


1. FUNGSI DAN KEMAMPUAN EA
----------------------------------------------------------------------

AsiaTradeCT V2 adalah Expert Advisor copy trading yang menghubungkan
terminal MetaTrader pada satu komputer atau VPS.

Kemampuan utama:

- Copy posisi BUY dan SELL.
- Copy pending BUY LIMIT, SELL LIMIT, BUY STOP, dan SELL STOP.
- Copy perubahan harga pending order.
- Copy Stop Loss dan Take Profit.
- Copy penutupan posisi dan pembatalan pending order.
- Mendukung MT4 ke MT4, MT5 ke MT5, MT4 ke MT5, dan MT5 ke MT4.
- Menyesuaikan jumlah digit dan tick size simbol copier otomatis.
- Menggunakan simbol chart masing-masing tanpa pengaturan suffix/prefix.
- Lot mengikuti master atau menggunakan fixed lot.
- Mendeteksi akun MT5 Netting atau Hedging.
- Dashboard untuk memilih role, mode lot, dan jam trading.
- Heartbeat untuk menampilkan status hubungan Master-Copier.

Yang belum didukung:

- BUY STOP LIMIT dan SELL STOP LIMIT MT5 tidak dicopy karena MT4 tidak
  memiliki tipe order yang setara.
- Copier pada VPS/komputer yang berbeda belum dapat terhubung langsung.
- Partial close atau perubahan volume posisi master belum disinkronkan.


2. PERSYARATAN PENGGUNAAN
----------------------------------------------------------------------

1. Terminal Master dan Copier harus berjalan pada komputer/VPS yang sama.
2. Sebaiknya kedua terminal berjalan menggunakan akun Windows yang sama.
3. Master dan Copier harus menggunakan InpChannel yang sama.
4. EA harus dipasang pada chart instrumen yang sama atau setara.
5. Simbol boleh memiliki nama dan digit berbeda.
6. Skala harga simbol harus sebanding.
7. AutoTrading/Algo Trading harus aktif pada setiap terminal.
8. URL lisensi harus dimasukkan ke daftar WebRequest setiap terminal.
9. LicenseKey harus aktif dan valid.

PENTING:

EA menggunakan FILE_COMMON, yaitu folder bersama terminal MetaTrader yang
terpasang pada satu komputer. FILE_COMMON bukan koneksi internet antar-VPS.


3. FILE YANG DIGUNAKAN
----------------------------------------------------------------------

MetaTrader 4:

  AsiaTradeCT V2 MT4.ex4

MetaTrader 5:

  AsiaTradeCT V2 MT5.ex5

File MQ4/MQ5 adalah source code. Pengguna biasa cukup memasang EX4/EX5.


4. INSTALASI PADA METATRADER 4
----------------------------------------------------------------------

1. Buka terminal MetaTrader 4.
2. Klik menu File.
3. Pilih Open Data Folder.
4. Buka folder MQL4.
5. Buka folder Experts.
6. Salin file berikut ke folder tersebut:

     AsiaTradeCT V2 MT4.ex4

7. Kembali ke MetaTrader 4.
8. Buka panel Navigator dengan Ctrl+N jika belum terlihat.
9. Klik kanan Expert Advisors lalu pilih Refresh.
10. Jika EA belum muncul, tutup dan buka kembali terminal MT4.
11. Pastikan tombol AutoTrading pada toolbar dalam keadaan aktif.


5. INSTALASI PADA METATRADER 5
----------------------------------------------------------------------

1. Buka terminal MetaTrader 5.
2. Klik menu File.
3. Pilih Open Data Folder.
4. Buka folder MQL5.
5. Buka folder Experts.
6. Salin file berikut ke folder tersebut:

     AsiaTradeCT V2 MT5.ex5

7. Kembali ke MetaTrader 5.
8. Buka panel Navigator dengan Ctrl+N jika belum terlihat.
9. Klik kanan Expert Advisors lalu pilih Refresh.
10. Jika EA belum muncul, tutup dan buka kembali terminal MT5.
11. Pastikan tombol Algo Trading pada toolbar dalam keadaan aktif.


6. MENGAKTIFKAN WEBREQUEST
----------------------------------------------------------------------

WebRequest diperlukan untuk memvalidasi LicenseKey.

Lakukan langkah berikut pada SETIAP terminal Master dan Copier:

1. Buka MetaTrader.
2. Klik Tools > Options.
3. Pilih tab Expert Advisors.
4. Centang:

     Allow WebRequest for listed URL

5. Klik Add new URL atau tanda tambah.
6. Masukkan URL berikut persis:

     https://asiatradevps.com

7. Klik OK.
8. Pasang ulang EA atau tunggu pemeriksaan lisensi berikutnya.

Jangan memasukkan path API lengkap. Cukup masukkan domain HTTPS di atas.


7. MEMASUKKAN LICENSEKEY
----------------------------------------------------------------------

1. Buka chart yang akan digunakan.
2. Tarik AsiaTradeCT V2 dari Navigator ke chart.
3. Buka tab Inputs.
4. Cari InpLicenseKey.
5. Masukkan LicenseKey yang diberikan oleh AsiaTradeVPS.
6. Pastikan pengaturan izin trading EA aktif.
7. Klik OK.

Jika EA sudah berada pada chart:

- Tekan F7 untuk membuka Properties EA.
- Buka tab Inputs.
- Isi atau ganti InpLicenseKey.
- Klik OK.

Validasi lisensi mengirimkan LicenseKey, platform, dan nomor akun trading ke
server lisensi. Jika lisensi tidak aktif pada akun tersebut, hubungi penyedia
lisensi.

Status lisensi yang normal pada dashboard:

     LICENSE ACTIVE

Kontak dukungan yang tertulis pada EA:

     @AsiaTradeAlgo
     @AsiaTradeVPS


8. MENAUTKAN MASTER DAN COPIER
----------------------------------------------------------------------

AsiaTradeCT V2 menautkan terminal menggunakan nama channel.

Langkah dasar:

1. Buka chart instrumen pada terminal Master.
2. Buka chart instrumen setara pada terminal Copier.
3. Pasang EA pada kedua chart.
4. Isi LicenseKey pada kedua terminal.
5. Isi InpChannel dengan nilai yang sama pada kedua EA.
6. Pada dashboard Master, pastikan tombol role menampilkan MASTER.
7. Pada dashboard Copier, klik tombol role sampai menampilkan COPIER.
8. Pilih mode lot pada dashboard Copier.
9. Tunggu indikator koneksi berubah menjadi ACTIVE.

Contoh channel:

     GOLD_01

Master dan Copier untuk satu pasangan harus menggunakan GOLD_01.

PERINGATAN ROLE:

Role awal EA adalah MASTER. Setelah EA dipasang ulang, terminal restart,
timeframe/chart berubah, atau EA diinisialisasi ulang, periksa kembali role
Copier dan klik sampai tertulis COPIER.


9. CONTOH MT5 MASTER KE MT4 COPIER
----------------------------------------------------------------------

Contoh konfigurasi:

Master MT5:

- Chart       : XAUUSDc
- InpChannel  : GOLD_01
- Dashboard   : MASTER
- License     : ACTIVE

Copier MT4:

- Chart       : GOLDm
- InpChannel  : GOLD_01
- Dashboard   : COPIER
- License     : ACTIVE
- Lot mode    : SAME atau FIXED

Nama XAUUSDc dan GOLDm tidak harus sama. EA Master hanya membaca order pada
chart XAUUSDc, sedangkan EA Copier hanya membuka order pada chart GOLDm.

Pastikan keduanya benar-benar instrumen emas dengan skala harga sebanding.
Jangan memasangkan chart XAUUSD dengan EURUSD.


10. PENJELASAN PARAMETER INPUT EA
----------------------------------------------------------------------

strKey

  Hanya garis pemisah visual bagian License Key. Tidak perlu diubah.

InpLicenseKey

  Tempat memasukkan LicenseKey AsiaTradeVPS.

strTrading

  Hanya garis pemisah visual bagian Trading Setting. Tidak perlu diubah.

InpChannel

  Nama jalur komunikasi Master dan Copier.
  Nilainya harus sama pada kedua sisi.
  Default V2 adalah AsiaTradeCT_V2.

  Gunakan channel berbeda untuk setiap pasangan chart.

InpLotMode

  LOT_SAME:
    Lot copier mengikuti angka lot master.

  LOT_FIXED:
    Semua order copier menggunakan InpFixedLot.

InpFixedLot

  Lot yang digunakan saat mode LOT_FIXED aktif.
  Contoh: 0.01, 0.05, atau 0.10.

InpMaxLot

  Batas maksimal lot yang boleh dibuka Copier.
  Lot tetap dibatasi oleh minimum, maksimum, dan step volume broker.

InpOnTime

  Jam mulai membuka posisi/pending baru berdasarkan waktu server broker
  Copier. Format HH:MM, contoh 08:00.

InpOffTime

  Jam berhenti membuka posisi/pending baru berdasarkan waktu server broker
  Copier. Format HH:MM, contoh 23:00.

  Jika InpOnTime dan InpOffTime sama, misalnya 00:00 dan 00:00, trading
  dianggap aktif 24 jam.

  Di luar jam trading, EA tetap dapat menyinkronkan SL/TP, close posisi,
  dan penghapusan pending. Filter jam hanya menahan pembukaan baru.

InpDeviation (MT5)

  Batas deviation/slippage order MT5 dalam point broker.

InpSlippage (MT4)

  Batas slippage order MT4 dalam point broker.

InpMagic

  Nomor dasar untuk mengidentifikasi transaksi copier.
  Sebaiknya jangan menggunakan kombinasi Magic dan Channel yang sama untuk
  sistem copy trade lain pada simbol yang sama.

InpCopySLTP

  true  : SL dan TP master dicopy dan diperbarui.
  false : Copier tidak memasang atau mengikuti SL/TP master.

InpCopyClose

  true  : Posisi copier ditutup dan pending dihapus saat hilang dari master.
  false : Close dan pembatalan master tidak diterapkan pada copier.


11. PENJELASAN DASHBOARD EA
----------------------------------------------------------------------

AsiaTradeCT V2

  Nama dan versi produk.

ACTIVE / OFF

  ACTIVE berarti heartbeat terminal pasangan berhasil terdeteksi.
  OFF berarti heartbeat pasangan belum ditemukan atau sudah melewati timeout.

  Master dapat tetap menampilkan OFF sebelum ada Copier aktif pada channel.

ACCOUNT MODE

  HEDGING:
    Akun dapat memiliki beberapa posisi terpisah pada simbol yang sama.

  NETTING:
    Akun hanya memiliki satu posisi bersih pada setiap simbol.

SYMBOL

  Simbol chart yang digunakan EA pada terminal tersebut.

CHANNEL

  Channel komunikasi yang sedang digunakan.

SOURCE / ROUTE

  Pada Master menampilkan mode akun sumber.
  Pada Copier menampilkan jalur mode akun Master menuju Copier, contoh:

     ROUTE HEDGING > HEDGING

Tombol MASTER / COPIER

  Klik untuk mengubah role EA.
  Master mengirim data. Copier menerima dan mengeksekusi data.

Tombol LOT SAME / LOT FIXED

  Klik untuk mengganti mode lot saat EA berjalan.

FIXED LOT

  Kolom untuk mengubah fixed lot dari dashboard.

START dan END

  Kolom jam mulai dan selesai trading berdasarkan waktu server broker.

Tombol SAVE

  Menerapkan Fixed Lot dan jam trading yang ditulis di dashboard.

  Perubahan dashboard berlaku saat EA berjalan. Setelah restart atau EA
  dipasang ulang, nilai kembali mengikuti parameter Inputs.

BROKER / GMT / WINDOW

  Menampilkan waktu broker, offset GMT, dan status jam trading ON/OFF.

Status Pos dan Pending

  Format Copier:

     Pos A/B/C | Pending D/E/F

  Pos:
    A = jumlah posisi baru yang dibuka pada siklus terakhir.
    B = jumlah SL/TP posisi yang diperbarui.
    C = jumlah posisi yang ditutup.

  Pending:
    D = jumlah pending baru yang dibuat.
    E = jumlah pending yang diperbarui.
    F = jumlah pending yang dihapus.

LICENSE

  Menampilkan status validasi LicenseKey dan masa aktif jika dikirim server.


12. CARA MENGGUNAKAN MARKET DAN PENDING ORDER
----------------------------------------------------------------------

MARKET ORDER

1. Buka BUY atau SELL pada simbol chart Master.
2. Master menerbitkan informasi posisi.
3. Copier membuka order pada Bid/Ask broker Copier saat data diterima.
4. SL/TP disesuaikan mengikuti digit dan tick size Copier.
5. Jika SL/TP Master berubah, Copier ikut memperbarui.
6. Jika posisi Master ditutup, Copier ikut menutup jika InpCopyClose=true.

Harga entry Copier mungkin sedikit berbeda karena spread, latency, dan sumber
harga broker. EA tidak menjamin entry persis sama dengan harga historis Master.

PENDING ORDER

1. Buat BUY LIMIT, SELL LIMIT, BUY STOP, atau SELL STOP pada Master.
2. Pending dibuat pada simbol chart Copier.
3. Perubahan harga, SL, TP, dan expiration disinkronkan.
4. Jika pending Master dibatalkan, pending Copier ikut dihapus.
5. Ketika pending berubah menjadi posisi, EA menjaga identitas order agar tidak
   sengaja membuat posisi duplikat.


13. PERBEDAAN DIGIT DAN NAMA SIMBOL BROKER
----------------------------------------------------------------------

EA menggunakan simbol chart masing-masing terminal.

Contoh yang diperbolehkan:

Master : XAUUSDc, 3 digit
Copier : GOLDm,   2 digit

Master : USDJPYm, 3 digit
Copier : USDJPY,  2 digit

Nilai SL/TP dan harga pending dinormalisasi ke digit dan tick size simbol
Copier secara otomatis.

Contoh:

Master 145.123 menjadi sekitar 145.12 pada Copier 2 digit.

Syarat penting:

- Chart Master dan Copier harus mewakili instrumen yang sama/setara.
- Skala harga harus sebanding.
- Jika Master sekitar 3,340 dan Copier sekitar 33,400, normalisasi digit saja
  tidak cukup karena terdapat perbedaan skala 10 kali.


14. AKUN HEDGING DAN NETTING
----------------------------------------------------------------------

HEDGING

- Setiap order menjadi posisi terpisah.
- BUY dan SELL dapat berjalan bersamaan.
- Lebih sesuai untuk copy trade per ticket.

NETTING

- Hanya satu posisi bersih per simbol.
- BUY dan SELL pada simbol sama saling menambah atau mengurangi.
- Beberapa posisi Hedging tidak dapat disalin satu-per-satu ke satu posisi
  Netting tanpa agregasi.

NETTING SAFETY

Pada MT5 Copier Netting, jika Master mengirim lebih dari satu item independen
pada chart yang sama, dashboard menampilkan:

     NETTING SAFETY: master has ... items

Sinkronisasi ditahan untuk mencegah posisi atau pending tercampur. Gunakan akun
Hedging untuk fleksibilitas copy per-ticket, atau batasi Master menjadi satu
item aktif pada simbol tersebut jika Copier memakai Netting.


15. PENGGUNAAN BEBERAPA PAIR
----------------------------------------------------------------------

Gunakan satu chart dan satu channel unik untuk setiap pasangan instrumen.

Contoh:

Pair emas:
  Master channel : GOLD_01
  Copier channel : GOLD_01

Pair EURUSD:
  Master channel : EURUSD_01
  Copier channel : EURUSD_01

Pair US30:
  Master channel : US30_01
  Copier channel : US30_01

Jangan menggunakan channel yang sama untuk instrumen berbeda karena file state
akan saling menimpa dan Copier dapat menerima transaksi yang salah.


16. STATUS DAN TROUBLESHOOTING
----------------------------------------------------------------------

LICENSE NO KEY

  InpLicenseKey belum diisi. Tekan F7 dan masukkan LicenseKey.

WEBREQUEST BELUM AKTIF / LICENSE WEBREQ 4014 / 4060

  Tambahkan https://asiatradevps.com pada:
  Tools > Options > Expert Advisors > Allow WebRequest for listed URL.

LICENSE HTTP xxx

  Server memberi status HTTP selain 200. Periksa internet, URL WebRequest,
  firewall, server lisensi, dan masa aktif LicenseKey.

LICENSE GRACE

  Server lisensi sementara tidak dapat diakses, tetapi EA masih berada dalam
  masa toleransi lisensi yang telah berhasil divalidasi sebelumnya.

WAITING MASTER FILE

  Copier belum menemukan file state Master.

  Periksa:
  - Master dan Copier berada pada komputer/VPS yang sama.
  - InpChannel sama.
  - EA Master aktif dan role menunjukkan MASTER.
  - License Master ACTIVE.

MASTER CONNECTION OFF

  File heartbeat Master tidak ditemukan atau sudah kedaluwarsa.
  Periksa terminal Master, koneksi, AutoTrading, lisensi, dan channel.

ACTIVE TIDAK MUNCUL

  Pastikan kedua EA hidup, menggunakan channel sama, dan lisensi aktif.
  Master baru melihat ACTIVE setelah menerima heartbeat Copier.

NETTING SAFETY

  Copier Netting menerima lebih dari satu item dari Master pada chart tersebut.
  Kurangi jumlah item Master atau gunakan akun Copier Hedging.

ORDER SEND / TRADE RETCODE / PENDING ERROR

  Periksa tab Experts dan Journal. Penyebab umum:

  - Market tutup.
  - AutoTrading/Algo Trading tidak aktif.
  - Lot tidak valid atau margin tidak cukup.
  - Harga pending terlalu dekat dengan harga pasar.
  - SL/TP terlalu dekat dengan harga pasar.
  - Expiration pending tidak didukung broker.
  - Simbol Copier tidak dapat diperdagangkan.

TRANSAKSI TIDAK TERCOPY

  Periksa:

  - Order Master berada pada simbol chart tempat EA Master dipasang.
  - Chart Copier adalah instrumen yang sama/setara.
  - Dashboard Master menunjukkan MASTER.
  - Dashboard Copier menunjukkan COPIER.
  - Status hubungan ACTIVE.
  - License kedua terminal ACTIVE.
  - Trade Window Copier dalam keadaan ON untuk order baru.
  - InpChannel kedua EA sama persis, termasuk huruf besar/kecil.


17. CHECKLIST PENGUJIAN
----------------------------------------------------------------------

Lakukan pengujian pada akun demo sebelum akun live:

[ ] BUY market Master muncul sebagai BUY pada Copier.
[ ] SELL market Master muncul sebagai SELL pada Copier.
[ ] Perubahan SL/TP Master diterapkan pada Copier.
[ ] Close Master menutup posisi Copier.
[ ] BUY LIMIT tercopy, dapat dimodifikasi, lalu dibatalkan.
[ ] SELL LIMIT tercopy, dapat dimodifikasi, lalu dibatalkan.
[ ] BUY STOP tercopy dan berubah menjadi posisi tanpa duplikat.
[ ] SELL STOP tercopy dan berubah menjadi posisi tanpa duplikat.
[ ] Broker berbeda digit menghasilkan harga yang valid.
[ ] Nama simbol berbeda tetap memakai chart Copier yang benar.
[ ] Restart terminal lalu role Copier dipilih kembali.
[ ] Channel berbeda tidak saling mencampur transaksi.
[ ] Status Netting/Hedging tampil benar.
[ ] Simulasi putus koneksi tidak menyebabkan order yang tidak diinginkan.


18. CATATAN KEAMANAN
----------------------------------------------------------------------

- Selalu uji versi baru pada akun demo.
- Gunakan InpMaxLot yang sesuai dengan risiko akun Copier.
- LOT_SAME tidak selalu menghasilkan risiko uang yang sama jika contract size,
  tick value, leverage, atau mata uang akun broker berbeda.
- Jangan memasangkan chart instrumen yang berbeda hanya karena harga terlihat
  mirip.
- Harga entry market Copier mengikuti harga broker Copier saat eksekusi dan
  dapat berbeda dari Master karena spread dan latency.
- Pastikan VPS stabil dan terminal tidak tertutup.
- Periksa kembali role Copier setelah restart atau pemasangan ulang EA.
- Simpan LicenseKey secara aman dan jangan membagikannya kepada pihak lain.


======================================================================
                         AKHIR PANDUAN
                         AsiaTradeCT V2
                         asiatradevps.com
======================================================================
